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BACKGROUND GRAPHICS 



Each level consists of up to 24 screens. Each screen consists of 30 
blocks (10 blocks wide x 3 blocks high), also referred to as "pieces." 
Examples of pieces are: floorpiece; pressure plate; spikes; solid 
block. 

The complete layout of each level is specified by a "level blueprint" 
($900 bytes long). 



COORDINATE SYSTEM 

The Apple screen is 40 bytes wide x 192 lines high, with 7 bits per 
byte. Most of the background graphics are don© on the byte 
boundaries (e.g.. an X-coordlnate of 39 puts you at the far right-hand 
edge of the screen). Since each screen breaks down Into 10 blocks 
across x 3 blocks high, that works out nicely with each block being 4 
bytes wide. 

The moving characters (player, guard, etc.) use a slightly different 
coordinate system. The X-coordinate is represented by one byte. 
The screen is 140 pixels wide, with 58 as the screen's left edge- 
giving us offscreen margins of 58 pixels on either side of the screen, 
(This makes it possible to compare the X-coordinates of two 
characters even if one Is offscreen.) 

Since all the character movements throughout the program are 
specified according to the 140'Wide coordinate system, we would 
like to keep the character's X-coordinate on a 140-wide screen (or a 
width that is a multiple of 140) for all the different conversions. 
The character's position could then be mapped to the actual screen 
width for that machine~320, 512. 640, or whatever-at the time 
the character is drawn. 



IMAGE TABLES 

There are two background image tables (bgtab1-2) and 7 character 
image tables {chtab1-7). 

t^h. table # Contents 

1,2,3,5 Player (kid); misc. shapes 

4 Enemy (guard, fat guard, skeleton, vizier, shadow) 

6,7 Shapes for princess scenes (princess, vizier, 

hourglass) 

Note: chtabe is too big to fit into memory all at once, so it is split 

into two files: 

chtabe.a used for opening title sequence & levels 1-2 
chtab6.b used for levels 3 and up, including victory sequence 

There are two sets of background images, one for the dungeon and 
one for the palace. 

See accompanying lists that describe the contents of chtab6-7 and 
bgtab1-2. 



MBMORYUSE 



The Apple version uses 



(during 

Image tables 
Player 
Enemy 

Princess & Vizier 
Bacltg round 
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memory, roughly, as follows: 
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Level 0 is the demo level. Although levels 13 and 14 are technically 
separate levels, the 'officiar highest level number Is 12. 
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1 * comnants 

2 * 

3 * 

4 * n 0 U E R 

5 * 

e * 

7 ♦ 

8 * Routines to keep track of moving objacts are contained 

9 * in the fi le hOUER. 

10 • 

11 * There are 2 types of moving objects: Transitional objects 

12 * <TROBs> and Mobile (Ejects <nOBs). 

13 * 

14 » TftOBs (e.g. gate, spikes, pressplate, torch) can have moving 

15 * parts ft change appearance, but reealn in a fixed location. 

16 * 

17 • rtOBs <folling floor> c«in eoue ail over the picice, including 

18 betmen screens. 
ig >f 

20 ♦ 

21 ♦ 

22 * THOBs ore kept track of in a data structure called 

23 * the 'trans list" as follows: 

24 * 

25 * nuntrans ^ ' 9l active TRQBs 

26 * 

27 • For X = 1 to numtrans 

28 ♦ 

29 trioc.x - block location C0-2g> 

30 • trscrn,x - screen • <l-24> 

31 * trdirec.x = direction of notion (means something different 

32 * for different kinds of objects) 

33 * 

34 * Uhen an object stops mowing, uim set its trdlrec = -1, then 

35 * remove the object from trans list on the next cycle. 

36 • 

37 * 

38 * 

3g * NOBs are kept track of in a similar data structure called 

40 * the -MOB 1 1st": 

41 ♦ 

42 ♦ nummob = « of active MOBs 

43 * 

44 For X ■ 1 to nummob: 

45 ♦ 

46 * mobx,x = byte (0-39) 

47 * moby^x = y-coord 

48 ♦ mobscrn,x = screen * 

49 * mobuel,x a velocity 

50 * mob type, X = type 

51 • 0: fal I ing floor 

52 * (No other HOB types defined at present) 

53 * mobievel,x = level (0-2} 

54 • 

55 « 

56 * 

57 ♦ The basic routine in HOUER Is flMlflTRflNS. This 

58 * routine, which Is called once per cycle, advances 



PRINCE OF PERSIA 



&/27/89 



commenls/l 



I Ists.' 



5Q 


* 


60 




61 


♦ 


62 


* 






G4 


* 






aft 


^I 


O r 


^^ 


RO 
OW 






* 






f 1 




r ^ 




11 

t<m 




ft 








r U 




f f 


1^ 




1^ 


70 
rv 


^ 


sn 




B 1 


ifr 




>t> 


SI 


1^ 




<¥ 




41 


fiA 
OO 


<¥ 


a r 


lit 


fill 


W 




Ml 


90 




91 


*- 






Q3 




94 


* 






vo 


4i 


V f 


1(1 


Q8 
»a 


* 




* 


inn 
1 uu 


jfC 


\Q 1 

lU 1 


>(' 




1^ 


1 UO 


4f 


1 U*f 








inA 




lU r 










* 


(10 


* 


f 11 




1 12 


* 


1 13 




114 




115 





all actfu« TROBs to their next phase (this includes 
d*l«ting TROBs that become jnacti(^e> and marks the 
opppoprlaU rttdraa buffvrs for each TROB. 

OUmp routines such as TRIGSPIKES^ PUSHPP, BREflKLOOSE, 
etc. are cal fed to add new TROBs to the trons i ist (when^ 
for axa»pla, a character juaps ouer spikes or steps on 
a pressure plate or loose floor). 

The routine RNIttlQBS performs the some function for 
the HOB list that RNItlTRRNS does for the trans iist. 
It ad>^ances all active MOBs to the position they will 
occupg in the next froM. 

Exanple: Uhen a character steps on a loose floor, the 

control routine senses this ft puts in a cal \ to 
BRERKLOOSE <which odds tha loose fioor to the trans 
list). For the next 10 frames or so, the loose fioor 
■ iggims <under the control of RNinTRRMS> until RhlflTRRNS 
decides It's tiee for it to fall, flt that paint, the 
loose floor is deleted from the trans list, the block 
is repiaced by "empty space", and a new MOB is 
created to take Its ploce. Under the control of 
RHinnOBS, the MOB then falls until it hits the ground, 
at which point flNinnOBS deletes the falling floor from 
the MOB list and changes the obj Id of the block It landed 
on to "rubble." 



FRflnERDU 



inAGE LISTS 

FRfltlERDV never calls hires routines directly. Instead, 
parameters of images to be drawn are stored in "image 



There are 6 separate Image lists: 

bg: Images in background plane (drawn first) 
X, V, IttO, OP 

wipe: Solid-color wipes (drawn with b.g. plana> 
X, V, H, U, COL 

fg: Images in foreground plane <drawn last> 
X, V, IMG, OP 

mid: images between b.g. and f.g. planes 

X, OFF, V, IMG, OP, TVP, CU, CO, CL, CR 

msg: Images In aessoga plana (drawn last of ail) 
X, OFF, V, IMG, OP 

gen: General Instructions (e.g. clear screen) 
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rn 




128 


* 


CL 


- left cutoff 


129 


* 


CH 


= right cutoff 


130 


* 


H 


- haight 


131 


• 


U 


- vldth <in bytes) 


132 


* 


COL 


■ color (for wipe only) 


133 


* 





134 * NOTE— bg, fg, gnd vipa calls qssum affs«t-0 

135 * 

136 * 

137 * Th«p« is also an "object list" with params similar to 

138 * Mid I \s\: 

139 • 

140 • X, OFF, V, I MO, FACE, TVP, CU, CO, CL, CR 

141 * 

142 * Hot* that obj list has 2 additional params: 

143 * 

144 * obJFHCE ■ Icft/rlght 

143 * obj TVP > Ob J act typa <Not to ba confused alth oldTVP) 

146 • 

147 * The object list has one entry for each object to be 

148 • draiun <e.g,, "kid," "foiling floor"). FRflttEflOU uses 
14ft * the object list to build the actual Mid list 

130 * of iMgas to ba draan. E.g., the single object "falling 

151 • floor" might tronslale into 3 seporala iaagas: 

tS2 ♦ fl-sacl i on, B-seci i on, and D-sect i on , 

153 ♦ 

154 * 

155 * 

156 REDRRU BUFFERS 

157 + 

158 * Each redrow buffer contains 30 counters, one for each 

159 * block on screen; 0 = skip, non-0 « radroa and decrement. 

160 * 

161 ♦ REOBUF: 

162 ♦ The most genera I -purpose buffer. Harking REDBUF for a 

163 block ail I cause all sections of the block to be rmdramn. 

164 * 

165 * UIPEBUF: 

166 * Uipe square <usual Ig to black). UHITEBUF contains 

167 ♦ wipe height, in lines. 

168 * 

169 * narking both REDUJF and UIPEmjF for a block will cause 

170 * the entire blodi to be erased ft redrawn. This is the 

171 * safest aag to redraw a block. 

172 • 

173 * nOUEBUF: 
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174 * Refers only to novabla portiesn of objsct <«.g. lowarlng 

175 * gate). Superseded by REDBUF. 
175 ♦ 

177 * FREDBUF: 

17B * Refers only to foreground plane. Harked when character 

179 * goes behind a post or other object aith a frontpieee, 

180 * Superseded by REDBUF. 

181 * 

182 * FLOORBUF: 

183 * Refers to floorpleces. Marked to the right of a 

184 * falling or hanging character, FLOORBUF causes floorpiece 

185 * to be drown in the aid plane (where it will cover up 

186 * character If appropriate). 

187 * 

188 * HRLFBUF: 

189 • Like FLOORBUF, but redraws a triangular section of 

190 * the floorpiece Instead of the whole thing. Used uihen 

191 * a character clings up on the left side of a floorpiece 
102 * and «• wnt to Msk out his lower body while letting his 

193 * upper body shoa. < Superseded by FLOORBUF.) 

194 * 

195 * OBJBUF: 

196 * Marked «hene<Jer objects need to ba drawn in a given block. 
107 * <Objects ore always the last aid elements drown In 

198 * a block. Objects ore assigned to blocks based on 

199 • their lower left x-y coords. Characters are considered 

200 objects. There con be multiple objects in a given block.) 

201 * 

202 * TOPBUF: 

203 * 10-byte buffer for row of D-sectlons across top of screen 

204 * <from screen above). 

205 • 

206 « Note that TOPBUF is a 10-byte buffer ehi la the others are 

207 * all 30 bytes. 

208 * 

209 * 

210 * 

211 * The specific routinas called by SURE <in FRAMERDU) for 

212 * each of these buffers are: 

213 • 

214 * REDBUF: redblock <dra«c, draeb, droenb, droed, drawmd, 

215 * draea, drama^ drawfrnt) 

215 * 

217 * UIPEBUF: eipesq 

216 * 

219 * nOUEBUF: draac, drawnc, draaab, drawna 

220 ♦ 

221 * FREDBUF: draafrnt 

222 * 

223 * FLOORBUF: draafloor 

224 ♦ 

225 * HflLFBUF: drawhalf 
225 * 

227 * OBJBUF: drawobjs 

22B * 

229 * TOPBUF: drawc, draab, redroad, draamd, draafrnt 

230 ♦ 

231 * 



PRINCE OF PERSIA 



8/27/89 



comments/ 4 













233 
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N T 
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Zo r 




LEUEL BLUEPRINT <fQQQ butH> 












239 






Start 


Length 


240 










Z4 1 




BlueTypa 


B700 


720 


242 


* 


B 1 uaSpec 


B9D0 


720 


243 




LinkLoc 


BCAO 


256 


244 


* 


Llnknop 


BDflO 


250 


245 




nop 


BEflO 


06 


24S 


« 


Info 


BFOO 


250 


247 


* 








248 




TOTRL: 2304 byt«s 





249 * 

250 ♦ 

251 * 

252 • BLUETVPE 

253 * 

254 ♦ Bytes 0-29 describe screen "1 

255 * Bgtas 30-59 " scraan «2 

256 * ate. 

257 * 24 scTMns total . 

238 * 

259 * Eoch BLUETVPE byte corresponds to on* block. 

260 * (30 blocks p«r £cra«n. > Blocks ar« nappad 
251 « Into BLUETVPE Icft-rlght, top-bottom. 

262 ♦ 

2G3 * FIND With 'StF to gat tha "obj id/' or objact 

264 * idantif Ication nuabar (0-31 >, of aach block. 

263 * 

266 * 

267 ♦ 

268 * BLUESPEC 

269 • 

270 * (Scraan blocks aoppad tha sona way as in BLUETVPE.) 

271 * 

272 * Taken together^ each poir of corresponding bytes in 

273 ♦ BLUETVPE and BLUESPEC contains all tha information 

274 * about an object. The BLUETVPE byte always contains 

275 * tha objaet id. Tha BLIESPEC byta functions diffarantly 

276 * dapandlng on what tha objact Is. 

277 * 

278 * For Ms^ob I e objects <gates, spikes, torches, etc) 

279 * BLUESPEC specifies the object's "state" (a.g. Is It 

280 * open, closed, soaeuihere in betaeen?> 

281 * 

282 * For static objects <floor, space, solid block, etc.) 

283 ■•■ BLUESPEC specifies the object's "pattern" (e.g. which 

284 * dasign appears on tha wall bohind lt?> 

285 * 

286 * For pressure plates, the BLUESPEC byta tells which 

287 • gates the pressure plate controls. Specifically, the 

288 * BLUESPEC byta is a pointer (0-255> to the first entry 
2&Q * in tha link list for this pressure plate. 
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290 • 

29 1 • 

202 ♦ 

293 ♦ Link list (LIMKL0C/LII1Kf1flP> 

294 ♦ 

295 * Contofns a list of th« gatas controlled by each pressure 

296 * plQle. Each pair of byt« specifies one plate-to-gate 

297 * I j nkaga . There can be up to 250 such 1 1 nkages I n a I eve I . 

298 * 

209 * LINKLOC: 

300 * Bits 0-4: gale screen posn (0-29> 

301 * Bits 3-6: low 2 bits of gate screen * (1-24> 

302 * Bit 7: 1 - this Is last antry, 0 - nore gates to co«a 

303 * 

304 * LINKmP: 

305 * Bits 0-4: pressplate timer <0-31> 

306 * Bits 5-7: high 3 bits of gate screen • 

307 * 

308 * If a pressplate controls nothing, LINKLOC ■ FF; LINKHAP 
300 * still functions as pressplate timer. 

310 * 

311 ♦ 

312 * 

313 * IWP 

314 * 

315 * Specifies ho«f the 24 screens of the level are connected. 

316 * 

317 ♦ Each screen gets 4 bytes corresponding to the screen *s 

318 * of the 4 adjacent screens. 

319 * 

320 • Bytes 0-3 = screen «1 

321 * Bytes 4-7 - screen «2 

322 * etc. 

323 * 

324 ■>■ For each screen: 

325 • Byte »l « screen to left 
32fi * Byte •2 - screen to right 

327 * Byte *3 = screen above 

328 * Byte «4 « screen below 
320 * 

330 • 

331 ♦ 

332 * IhFO 

333 * 

334 * Bytes 0-63 : reserved for ed i tor 

333 * 

336 * Bytes 84-255: Information about starting positions 

337 * of player K other characters on this level. 

338 * <See MMEQ for detai is. ) 
330 * 

340 • 

341 • 

342-HSEQTABLE 

343 ♦ 

344 ♦ 

345 ♦ 

346 * Frone def I ist: 

347 • 
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34B 


• 


1200 buUs al 1 


locatsd — 240 frames, 5 bytos each 


349 




<241-2S5 resarvad as coMnands) 


350 








351 




FroMft dafinition consists of: 


352 


* 






353 


* 


<1> Flliago 






* 






355 


* 


Bit 7 » chtoblo • <0-7), bit 2 


356 








3S7 

r 




B s *v n_K a 

B 1 IS U~0 ■ 


1 Hla^a ^ \ V lAff 












m 


CI MMBDV ■ 








^UU ^ X . 






* 




fhinhla 5 6 7 8 


3113 


* 






363 


* 


\ 4 / r SWOTu 
















Bits B-7 - 


chtablo • <0-7>, bits 0-1 










4W r 




Bits 0-5 * 


pointer to SUORDTAB froM <0-53> 




* 








HI 


surnwRV: 








$00 ♦ x: 


ch table 1,5 




* 


$40 * x: 


chtable 2,6 


372 




$80 + x: 


chtable 3,7 


373 


* 


$c0 + x: 


eh table 4,8 


374 


* 








* 


<3> Fdx 




376 








177 




X-shirt In 


pixels <+ ■ fuid, - » bkwd> 


37& 


* 


(NOTE horizontal ruolution is 140 plxols) 


370 


* 






3fi0 


* 


<4> Fdy 




3BI 


• 






382 




V-shirt In pixols C+ - down. - - up> 


383 




CFroao ^IS 


Is defined as unshifted) 


3&4 


<¥ 






385 


« 


(5> Fchacfc 




3S6 


* 






387 


* 


Bit 7 ■ odd/even pixel 


38S 


* 










Bit 6 - 1 


if floor check is required (i.e., if weight 




• 


Is on floor> 


vV 1 










* 


Bit 5 - 1 


to "thin" this froM for collision detection 


303 


* 






344 




S 1 ts 0-4 - 


number of pixels (0-31 > froe left edge of 






i inag« b 1 


ock to base x-coord 






(usual ly 


cwitar of foot bearing character's weight) 


307 


* 




30S 


* 


sunnHRV: 




399 


* 


$c0 + x: 


check, odd 


400 


* 


$40 + x: 


check, even 


401 


* 


$80 + x: 


no check, odd 


402 


* 


$00 + x: 


no check, even 


403 


* 






404 




+ $20 to set bi t 5 


405 


* 
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406 *~ 

407 * 

408 * SEQPOrNT is 2-bi|te pointer to charactttr's currant 
4QC| * pos i t i on in sequence tab I a . 

410 * 

411 * Sfiq pointsr is increMntvd by 1 vith aach franc-advance. 

412 • 

413 * CTRL can jump saq pointer around at ni 1 1 <«.g., In response 

414 • to jovjsticK coateand) 

415 * 

416 * POSITIVE seq table values represent frame minbers. 

417 * HEGflTlUE values are instruction codes. 

418 * 

419 * Sequence table instructions: 

420 * 

421 * goto NN jump seq pointer to NN <lo« byte flrst> 

422 * aboutfoc* change K I DFRCE direction 

423 * up up one f I oor 

424 * down down one floor 

425 * chx n KIDX KIDX + N <BEFORE uie drew next frame) 
42G ♦ chy N KIDV KIDV + M <ditto> 

427 ■*■ act N change action code to li 

428 setfall X,V sat Initial x,y ualocity for fraafal I 

429 * 

430 * fiction codas: 

431 * 

432 * -1 » d«ad 

433 ♦ 0 " standing stl 1 1 

434 * 1 M running, juaping, other actions 

435 « that require a floor beneath your feat 

436 * 2 ■ hanging, climbing, and all other actions that 

437 * require holding onto a ledge 
43S ♦ 3 - in ■idair <brlefly> 

439 * 4 = in freefall 

440 + 5 = being bumped 

441 * 6 ■ hanging straight 

442 • 7 « turning 

443 * 

444 * Screen resolution is 140 x 102. 

445 * 

446 * 

447 * 

448 * NOTE: Frame table offsets are TEMPORRRV; sequence table 
44g ♦ offsets are PEIttlHhEhT. 

450 * 

451 * CTRL draws each frame at IKIDX + Fdx, KIDV + Fdy], 

452 ♦ but reaves KIDX & KIDV unchanged for the next frame. 

453 * "Chx" and "Chy" instructions In sequence toble^ however, 

454 * change KIDX K KIDV permanently. 

455 • 

456 ♦ For JUnPHflNG, CLIUBUP, etc., the idea is for KIDX, KIDV & 

457 * KIDLEUEL to keep the kid where he started —at the end 

458 ♦ of the block behind & below the one he's hanging from — 
455 * and use only the frame list x ft y offsets, until he's baak 

460 * on the ground. This way, we can branch into either HflMGDR(P 

461 * or CLIMBUP froa any point in HRNO. 

462 * 

463 * The first 4 frames of STARTRUN also use only the frame list 
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464 • offsets. This l«ts us switch vasl ly to, say, FULLSTEP 

465 >•• or STANDJUMP. 

466 ♦ 

467 4> 

468 * 

469 • n I S C 

470 • 

47 1 * 

472 ♦ 

473 • Potion IDs 

474 • 

475 * 0 Enpty 

476 * 1 Regular healing 

477 * 2 Boost strength 

478 « 3 Malghtloss 

479 * 4 Upside dovn 

480 • 5 Poison 

481 * 

482 • 

483 * 

484 • Charactar IDs 

485 • 

486 * 0 Kid 

487 * 1 Shadow 

488 • 2 Guard 

489 *m Uizler <\n gcwa) 

490 * 4 Skeleton 

491 * 5 Princess <in princess cuts) 

492 * 6 Vizier (in princ«ss cuts> 
403 ItouftC 

494 * 



— End assembly, 0 bytes. Errors: 0 
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J, 

* Character antmatioo commtnts 

* 

* 

* For each character, we maintain a 16-byte block of data 
» (referred to as "ct^aracter data' or "character vars') 

* that describes the character's current Dosition 4 what 

* he \% doinq. The 16 b/tes are allocated as -follows: 
» 

* CharPosn 
» 

* Frame tt o-f the character's current position. E.g., 

* CharPosn = 15 re-fers to frame #15 of the frame list, or 

* "standing still." 
« 

* CharX 
» CharY 
K 

* Character X & Y coords, based on a 140 x 192 screen. 
» (Upper left corner is X = 58, Y » Q) 

s 

* Char Face 
« 

* Direction character is facing: 0 « right, -1 ^ left 
* 

» CharBl ocKX 
« CharBl DcKY 

* ■ 

*t Coords OT character's current olocK '^X = 0-?, Y = 0-2). 

« {0,C> is usDer left block. 

« 

* CharAct ion 

» Code containing information about character's current 

* actlcr. E.g., CharActior. = 4 means "falling," This 
« t;a'-isb'e is used in a variety of different ways in 

* different situations 

* Charxyel 

* CnarYUel 

* X Hi. " componen-.; ;t cratncter's velocity ^during 

* -f: ee-re."; U . s.-M'-y Trame, CharXs/el is added to CharX and 

* Ch~-Yyei is added to Cha-Y, 
* 

* CharSeq ^2 bytes) 
* 

* Pointer to current address in the se(iuence table. 
* 

* CharScrn 
• 

* Screen 9 of character's current screen. <0 for null 

» screen.) 
« 

* CharRepeat 

* Uhen character stands at the edge of a chasm & takes a 



-"—^ Page 2 == 

* cautious step -fopward, the -first time he tries it he only 

* "tests" with his -foot. This c-uses CharRepeat (usually 

* i non-0 value) to be set to 0. The next time he tries i 
» cautious stepi he will step right oii the edge. 

* 

* ChsrlD 
« 

* Identi-fies character: 

* a = tcid 

* i " shadow man 

* 2 = gusrds, v i zi er 

* 4 " sKel eton 

* 5 * princess (in princess scenes) 

* 6 = yizier <in princess scenes) 
X 24 = mouse 

ff 

* CharSword 
« 

* 2: sword drawn 

* Oi sword sheathed 

4 

* CharLi-fe 

* -1 ! al iue 

n 0-127: dead 
* 

* 

* Two permanent sets CharData are maintainedi KidData 
« (-for the 5,nQ ShadC'Sta ':*or- his opponent). Note 

* that the ODDonent data is aluays re-ferred to by the 

* pre-fisi "Shed" i" t^-cuc". the characte- me.y be the shacoy; 
•* rran , ske"*tor, Ui:.?-, ixz. 

K 

« CharData its?'- ^s used as temporary storage -for wnlcheue:- 

* c-.aracre- wf want tc deal with. Typically, uie will call 

* -oadKid to "load" the ^ i c-j'' cu'^-erT c'.ara-U- C ' . s . , 

* load the 16 bvtes oi KidDat* intc the CharDais space), 

* then LBi? tha -lontroi f'outines that change CrarData, then 

* when we're cione co'^t 5a-,'eKid to "save' the roodi-f'^d 

* CharDste back Int: i d*.''ars . Th ^ s way we can use tne 

* same contro' routines -or both tne & 'f-'S spDonent. 

* There :5 a seconc usta set used tor tenporary =.!-.o~5ge 

« Ctppriate. QprData always contains the "other" character 

* than CharDsta — w^en we c;'l LoadK^d, we load 

* KidData irto CharOata and ShadData into QppData. 
* 
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INFO 

The INFO block of the level blueprint specifies the starting positions & 
characterisfjcs of the player & all guards in the level: 

There are three player variables: 

KIdStartScrn player starting screen (1-24) 
KidStartBlock starting block # on that screen (0-29) 
KidStartFace facing direction (-1 = left, 0 = right) 

There are six guard variables. A complete set of sbc variables is maintained 
for each of the level's 24 screens. 

GdStartBlock starting block # on this screen (value >29 means no 
guard on this screen) 

GdStartFace facing direction (-1 = left. 0 = right) 
GdStartX starting X-coord (140^M■dth coord) 

GdStartSeqL'H starting posn in sequence table (2-byte) 
GdStartProg guard program » (0-11) 



AUTO 

ADDGUARD 

On a cut to a new screen, we call ADDGUARD. ADDGUARD first checks for 
ttie hard-wired shadowman appearances on certain levels. (The 
shadowman is different from a normal guard and will be discussed later. 
The Vizier and the skeleton are treated as guards.) If none of these apply, 
we fall through to AddNormalGd. 

AddNormalGd checks the variables described in the section atwve (in the 
INFO block of the blueprint for tNs screen) to see if there is a guard on the 
new screen. 

Note: GdStartBlock is used to derive CharY, CharBlockX is derived from 
GdStartX. The precise value of GdStartBlock therefore doesn't matter; there 
are effectively only three values. 

The guard's starting position is derived from GdStartSeqL'H, which retain 
the 2-byte value of CharSeq. If GdStartSeqH « 0, that tells us to use the 
default CharSeq value (usually 'alertstand"). Once we have set CharSeq, 
we call ANIMCHAR to get the initial value of CharPosn. The next step is to 
check CharPosn to see if the guard is dead or alive. 



CUTCHECK 



When ttie character leaves a screen, we need to save the new position of 
the guard (if any) on that screer>~so that if he comes back to that screen 
later, the guard will be In the correct position. This is accomplished by 
CUTCHECK. 

When we leave a screen, we have two choices: UPDATEGUARO or 
TRANSFERGUARD. 

U PDATEG UARD updates all the guard data for the old screen 
(GdStartBlock, etc.) so that the guard will be in the correct position when we 
return. It also removes the guard as an active character (i.e.. sets ShadFace 
- 86 and OppStrength = 0). 

TRANSFERGUARD Is used when we want the guard to follow the player to 

the next screen. In this case, all we need to do is remove the guard from his 
old screen (set GdStartBlock > 29 for that saeen) and change CharSorn. 
CharX, & CharBlocKX to put the guard on the new screen. Theoretically, a 
guard can follow the player across any number of screens (by repeated use 
of TRANSFERGUARD). When the player finally leaves the guard behind, 
UPDATEGUARD saves the guard's new position, so that the guard can end 
up many screens away from where he started. 

CharFace - 86 Is the code for "nonexistent character.' You can also 'get rid 
of' a character by setting his CharScm ¥■ VisScm. Note that OppStrength is 
handled independently from the CharVars. so if you want to remove a 
guard's strength meter as well as the guard himself, you need to set 
OppStrength - 0 as well. 

Shadow man 

The shadowman is not treated as a guard. Throughout the program, various 
specialized bits of code check for specific drcumstances which %vill cause 
the shadowman to appear, disappear, change position, etc. 

The routine CSPS ('change shadowman position") puts the shadowman in 
a new position. His new position is specified by a data set of 8 bytes: 
CharPosn, X, Y, Face, BlockX, BlockY, Action, and the sequence table entry 
point. 

ENEMY FIGHTING LOGIC 

There are 12 different enemy fighting programs. Each is defined by a set of 

8 values: 

strikeprob 

restrikeprob 

blockprob 

impblockprob 

advprob 

refractimer 



specialcolor 
extrastrength 

The first 5 values specify fighting characteristics. E.g.. STRIKEPROB = 
prot)atNli^ x255 of strildng from a ready position. (0 = never, 255 = always). 

REFRACTIMER Is the length (# of frames) of the guard's "refractory period" 
after t)eing hit. 

SPECIALCOLOR specifies whether the guard's uniform is the hflgin minr for 
that level (0) or the special color (1 ). 

EXTRASTRENGTH specifies how many extra strength points (0-1) that 
guard gets above the tiasie strength for that level. 

'Basic strength' and 'basic color' are indexed by level numlDer. 

ENEMY SHAPE SETS 

The enemy shape sets are: 

guard 
fat guard 
Vizier 
skeleton 
shadowman 

Since the enemy shape set (chtable4) is loaded in at the beginning of the 
level, all the enemies on a given level must use the same shape set. (The 
guards' uniform colors, however, can vary from screen to screen within the 
level.) This is why Levels 3 (skeleton) and Level 6 (fat guard) have no other 
enemies. 

Level 12 

Level 12 is actually three separate levels, all of which daim to be Level 12. 
The real Level 1 2 starts at the bottom of the tower. After you've defeated the 
shadowman and njn off to the left, Level 13 is loaded in, with the Vizier 
shape set replacing the shadowman shape set, The first screen of Level 13 
is identical to the last screen of Level 12, for continuity, but there is no way 
for you to get back. (If you die on Level 13, you will be restarted at the 
beginning of Level 13-but the message will still say Level 12.) After you kill 
the Vizier and climb the stairs at the end of Level 13, you go to the Princess's 
level, which is technically Level 14. (Levels 12 and 13 both use the 
dungeon background set, wtille Level 14 uses the palace set.) 

If your time njns out while you're on Level 13, the game doesn't end (on the 
theory that while the Vizier is engaged in combat with you, he cant do 
arming to the Princess) until you die. 
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PRINCE OF PERSIA-Cheat Key Version 
August 27, 1389 



SKIP Skip to next level (up to Level 4)-Reduces time 

remaining to 15 minutes 
??? Enable cheat keys 

With cheat kevs enabted: 

[RetumI Disable cheat keys 

SKIP ... Skip to next level (up to Level 12) 



TINA Go to end of level 12 

R Restore full Strength 

BOOST Boost max strength (ongstrength) by 1 

Z Reduce guard to 1 unit of strength 

ZAP Zap guard (he drops dead) 



Prince of Persia snunri cffffT^tft 



Note: Not all of these are in the Apple version. 

Footsteps 

Soft landing 

Medium landing ("Oof!") 

Hard landing (SplatI) 

Sword clash 

Stab opponent 

Stab skeleton 

Stabbed by opponent 

Bones leap to life 

Impaled by spikes 

Slicer blades clash 

Character gets sliced in half 

Gate rising 

Gate stops at top 

Gate coming down slow 

Gate reaches bottom (Clang!) 

Gate crashes down 

Entrance door closes 

Exit door opening 

Bump into wall (soft) 

Bump into wall (hard) 

Bump Into mirror 

Falling floor lands on your head 

Loose floor shakes 

Falling floor lands 

Drink potion--l unit of strength restored 

Drink special potion-strength boosted to higher level 

Drink poison (lose 1 unit of strength) 

Unsheathe sword 
Jump through mirror 
Grab on to ledge 
Drink potion (glug glug) 



